package com.example.forum.services;

import com.example.forum.model.Board;

import java.util.List;
/**
 * 板块接口
 */
public interface IBoradService {
    /**
     * 查询num条记录
     * @param num  要查的条数
     * @return
     */
    List<Board> selectByNum(Integer num);
    /**
     * 当前板块文章数量+1
     */
    void addOneArticleCountById(Long id);

    /**
     * 根据板块id查询信息
     *
     */
    Board selectById(Long id);

    /**
     * 将板块的帖子数-1
     */
    void subOneArticleCountById(Long id);
    
    /**
     * 获取所有板块（管理功能）
     * @return 所有未删除的板块列表
     */
    List<Board> getAllBoards();
    
    /**
     * 添加新板块
     * @param board 板块信息
     */
    void addBoard(Board board);
    
    /**
     * 更新板块信息
     * @param board 板块信息
     */
    void updateBoard(Board board);
    
    /**
     * 更新板块状态
     * @param boardId 板块ID
     * @param state 状态(0正常,1禁用)
     */
    void updateBoardState(Long boardId, Byte state);
    
    /**
     * 删除板块（逻辑删除）
     * @param boardId 板块ID
     */
    void deleteBoard(Long boardId);
    
    /**
     * 更新板块排序
     * @param boardId 板块ID
     * @param sort 排序值
     */
    void updateBoardSort(Long boardId, Integer sort);

    /**
     * 修复板块的文章计数，将其设置为实际文章数
     * @param boardId 板块ID
     * @return 修复后的文章数
     */
    int fixArticleCount(Long boardId);

    /**
     * 获取板块实际文章数量（实时统计）
     * @param boardId 板块ID
     * @return 实际文章数量
     */
    int getActualArticleCount(Long boardId);
}
